home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-06 / novbat.zip / NOVBAT.DOC < prev    next >
Text File  |  1991-11-26  |  85KB  |  3,626 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                        ╔═══════════════════╗
  10.                        ║ ** N O V B A T ** ║
  11.                        ╚═══════════════════╝
  12.  
  13.           A Novell Netware Batch File Enhancement Utility
  14.  
  15.  
  16.               [EVALUATION VERSION: Distribute Freely]
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                     Designed and Developed by:
  28.  
  29.                        █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  30.   █▀█▀█▀▀█▀▀█▀▀▀█▀▀▀█▀▀▀ H O R I Z O N S ▀▀▀▀█▀▀▀█▀▀▀█▀▀█▀▀█▀█▀█
  31.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Consulting ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  32.     ≡ 1432 E. Commercial Street ─ Springfield, MO  65803 USA ≡
  33.  ≡ Phone:(417) 839-2174, Fax:(417) 831-1329, BBS:(417) 831-9140 ≡
  34.  
  35.                     CompuServe ID:  72557,3645
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.    ────────────────────────────────────────────────────────────
  44.              Copyright (C) 1991 by Horizons Consulting
  45.    All Rights Reserved * Revision 1.06E * Release Date 11/26/91
  46.    ────────────────────────────────────────────────────────────
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.       Horizons  Consulting  is a registered  Novell   Professional
  57.  Developer  tm and  has  developed  NovBat  with  Cooperation  and
  58.  assistance provided by Novell Incorporated.
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  COPYRIGHT:
  71.  
  72.  This manual and all accompanying software are copyrighted and all
  73.  rights  are  reserved.  The evaluation version of NovBat  may  be
  74.  freely  distributed for the purpose of suitability testing  only.
  75.  If, after a 2 week testing period, you determine NovBat to be  of
  76.  value  to your operation, purchase is required.  This  evaluation
  77.  version does contain an intermittent information screen to  indi-
  78.  cate  that this in only for testing and not for  production  use.
  79.  The  commercial  version  does not contain  this  prompt  screen.
  80.  NovBat is a trademark of Horizons Consulting.
  81.  
  82.  ACKNOWLEDGMENTS:
  83.  
  84.  The  author would like to thank the following people for  helping
  85.  to make this product possible:
  86.  
  87.       The  Novell  Netwire users, from whom  the  inspiration  for
  88.       NovBat originated.
  89.  
  90.       Harvey  Jamison for proofreading and listening to a  lot  of
  91.       sometimes boring concepts.
  92.  
  93.       Borland  for continuing to provide high quality  development
  94.       tools at a fair price.
  95.  
  96.       And  to all the users who purchase the program,   a  special
  97.       thank you.
  98.  
  99.  TECHNICAL SUPPORT:
  100.  
  101.       If you have difficulty understanding or using NovBat, we are
  102.  available to provide any assistance you need.  Product support is
  103.  provided in several ways.  First, you can call our switchboard at
  104.  (417)  839-2174.   Our technical support staff will  answer  your
  105.  questions as quickly as possible.  Secondly, technical support is
  106.  also  available on Compuserve.  Feel free to leave  questions  or
  107.  comments  to  Account #72557,3645.  We will normally  respond  to
  108.  CompuServe messages within 24 hours.
  109.  
  110.       We  also  have a 24-hour product support BBS.   This  allows
  111.  users  with modems to leave questions about support issues.   The
  112.  BBS  number  is (417) 831-9140. It supports 2400  and  1200  baud
  113.  modems.  Use 8 bit, No parity, 1 stop bit (8N1) to call in.   You
  114.  can  leave  questions and comments about NovBat,  check  for  the
  115.  latest  version, read how others are using NovBat on  their  net-
  116.  works, and download evaluation versions of our other products.
  117.  
  118.  BACKGROUND:
  119.  
  120.       NovBat  was developed in the fall 1991.  Ever since  getting
  121.  into  networking,  I've  been surprised by the  lack  of  Netware
  122.  support available from batch files.  After noticing several other
  123.  statements  to that effect on the Netwire forum of Compuserve,  I
  124.  decided  to do something about it.  What was needed was  an  easy
  125.  method  of allowing batch files to ask Netware for the wealth  of
  126.  information about the operating environment that constitutes  the
  127.  net.  NovBat is the result of these efforts.
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.       While  you can execute NovBat from the DOS command line,  it
  136.  was  developed for use in batch files.  NovBat allows your  batch
  137.  files to query the Netware operating system for information.  The
  138.  results  of  these  queries can then be used to  modify  a  users
  139.  environment,  an  applications configuration,  or  whatever  your
  140.  environment requires.
  141.  
  142.  
  143.  COMPATIBILITY:
  144.  
  145.       NovBat  was designed for and is compatible with Novell  Net-
  146.  ware.   It is not designed to work in conjunction with any  other
  147.  network  operating  systems. It is NOT  compatible  with  Netware
  148.  Lite, which is the limited peer to peer connectivity product from
  149.  Novell.   At  the  time of this writing Novell  has  not  offered
  150.  developers  access  to the Netware Lite internals which  are  re-
  151.  quired  to make NovBat compatible with this product.   NovBat  is
  152.  compatible with all versions of DOS since 3.0.
  153.  
  154.  WHAT IS NOVBAT?
  155.  
  156.       NovBat is a program that gives you the ability to ask Novell
  157.  Netware  for specific information about many aspects of the  net-
  158.  work.   This data ranges from information about the  user,  group
  159.  memberships,  servers, and network addresses  to  local-hardware-
  160.  specific  information.  By using NovBat you can  develop  network
  161.  intelligent batch files.  There are many instances where the  use
  162.  of  NovBat will save time and effort.  If you find yourself in  a
  163.  situtation where you would like to see something added to NovBat,
  164.  give  us a call.  It might warrant another command or  perhaps  a
  165.  slight  aberration of an existing command.  We are interested  in
  166.  making  sure that NovBat is a package that network users want  to
  167.  use!  It is from user feedback that the best products develop.
  168.  
  169.  
  170.  HOW DO I USE NOVBAT?
  171.  
  172.       Using NovBat is not difficult.  NovBat has 47 commands where
  173.  each do a very specific type of query from the Netware  operating
  174.  system.   Many of these commands have additional  parameters.   A
  175.  complete  description  of each NovBat command  will  be  provided
  176.  later.
  177.  
  178.       The NovBat commands are divided into two groups.  The  first
  179.  group  is  called the "ERRORLEVEL" group because  these  commands
  180.  return an ERRORLEVEL status code to your batch file.  The  second
  181.  group  is called the "ENVIRONMENT" group because  these  commands
  182.  place  their results into the environment space for later  refer-
  183.  ence by either your batch files or other applications.
  184.  
  185.       The  "ERRORLEVEL"  commands  all return a  standard  set  of
  186.  ERRORLEVEL  codes.  When a given NovBat query is processed  there
  187.  are  three possible ERRORLEVEL codes:  1 for True, 0  for  False,
  188.  and 255 for Error Condition.  These are the only ERRORLEVEL codes
  189.  that NovBat will generate.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.       The  Novbat "ENVIRONMENT" commands, in addition  to  placing
  202.  their results into the environment area, will exit with an ERROR-
  203.  LEVEL code of 0 unless there was an Error in which case an ERROR-
  204.  LEVEL of 255 will be generated.
  205.  
  206.       Since  both groups of commands always return  an  ERRORLEVEL
  207.  code  of  255 in the event of problems, we recommend  you  design
  208.  your  batch  files to trap an ERRORLEVEL 255.   Some  errors  are
  209.  important enough that NovBat will display its own error  messages
  210.  in addition to returning the 255 error code.
  211.  
  212.       The "ENVIRONMENT" commands normally place their results into
  213.  an  environment variable called "NOVBAT=", but you  can  override
  214.  this default and specify your own environment variable by  simply
  215.  adding  the name of the desired environment variable as an  extra
  216.  parameter at the end of any NovBat "ENVIRONMENT" command.
  217.  
  218.  THE NOVBAT COMMAND LINE:
  219.  
  220.  
  221.       The legal syntax for using NovBat is:
  222.  
  223.            NOVBAT command [parameter1] [parameter2]
  224.  
  225.       Where command is one of the 47 legal NovBat commands.   (See
  226.  Appendix  A for a summary list of all the legal NovBat  commands)
  227.  The  parameter  elements  of a command vary  according  to  which
  228.  command is being used.  Some commands do not need any parameters.
  229.  In  some  cases parameters are required and  sometimes  they  are
  230.  optional.   Never are more than two parameters required.   NovBat
  231.  commands  and  parameters are not case sensitive; that  is,   the
  232.  expressions "NOVBAT SizeOfGroup everyone" and "NOVBAT sizeofgroup
  233.  EVERYONE" are considered the to be the same command.
  234.  
  235.       You can generate a list of all the legal NovBat commands  at
  236.  any time by typing: "NOVBAT /?" or "NOVBAT HELP".
  237.  
  238.       While most of the commands that make up NovBat require  that
  239.  you  be using Novell Netware, a few do not.  These commands  pro-
  240.  vide  information about such things as your DOS  version,  memory
  241.  sizes and usage, video type, processor, and other system-specific
  242.  parameters.   If  your workstation also has  local  capabilities,
  243.  feel free to use these NovBat commands to your benefit even  when
  244.  you are not attached to the network.
  245.  
  246.       In the section that follows, each command in completely  and
  247.  independently  documented in alphabetical order.  Those  commands
  248.  that  will function independent of Netware are so indicated.   If
  249.  you  have  any questions or comments regarding  NovBat,  or  this
  250.  documentation,  please feel free to give us a call at (417)  839-
  251.  2174.
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  DoesGroupExist?
  269.  ______________________________________________________________________
  270.  
  271.  Function:  Verifies the existence of a specified Netware group.
  272.  
  273.  Syntax:    NOVBAT  DoesGroupExist?  NameOfGroup
  274.  
  275.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  276.  
  277.  Remarks:
  278.  
  279.       Sometimes  it is useful to verify the existence of  a  given
  280.       Group; the DoesGroupExist command will accomplish this.  You
  281.       must be logged into the server to use this command.
  282.  
  283.  See Also:  DoesGroupHaveMember?, SetSizeOfGroup
  284.  
  285.  Example:
  286.  
  287.       :Start
  288.            @ECHO OFF
  289.            NOVBAT DoesGroupExist? %1
  290.            If ErrorLevel 255 goto Error
  291.            If ErrorLevel 1 goto GotGroup
  292.  
  293.       :NoGroup
  294.            ECHO Sorry, Group Does Not Exist.
  295.            goto End
  296.  
  297.       :GotGroup
  298.            ECHO Yes, That Group Does Exist.
  299.            goto End
  300.  
  301.       :Error
  302.            ECHO You Got a problem here.  Try Logging In First!
  303.       :End
  304.  
  305.  
  306.  
  307.  
  308.  ______________________________________________________________________
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  DoesGroupHaveMember?
  335.  ______________________________________________________________________
  336.  
  337.  Function:  Verifies that a user is a member of a specified group.
  338.  
  339.  Syntax:    NOVBAT  DoesGroupHaveMember?  NameOfGroup  NameOfUser
  340.  
  341.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  342.  
  343.  Remarks:
  344.  
  345.       This  command has one required and one  optional  parameter.
  346.       The first parameter, NameOfGroup, is required and should  be
  347.       a  valid group name.  The second parameter,  NameOfUser,  is
  348.       optional.   If  absent NOVBAT will assume the  current  user
  349.       <Self> as the name to look up.  You must be logged in to use
  350.       this command.
  351.  
  352.  See Also:  DoesGroupExist?, SetSizeOfGroup
  353.  
  354.  Example:
  355.  
  356.       :Start
  357.            @ECHO OFF
  358.            NOVBAT DoesGroupHaveMember? ACCOUNTING %name%
  359.            If ErrorLevel 255 goto Error
  360.            If ErrorLevel 1 goto IsMember
  361.  
  362.       :NotMember
  363.            ECHO Only Accounting Dept. can access this function!
  364.            goto End
  365.  
  366.       :IsMember
  367.            ECHO ACCOUNTING ACCESS GRANTED.
  368.            map k:=f:\ACCOUNTING
  369.            goto End
  370.  
  371.       :Error
  372.            ECHO Sorry, but you not logged in I'm Afraid!
  373.       :End
  374.  ______________________________________________________________________
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  DoesUserExist?
  401.  ______________________________________________________________________
  402.  
  403.  Function:  Verifies that a given name has a user account.
  404.  
  405.  Syntax:    NOVBAT  DoesUserExist?  NameOfUser
  406.  
  407.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  408.  
  409.  Remarks:
  410.  
  411.       The DoesUserExist? command verifies the existence of a given
  412.       user.  The parameter NameOfUser is required.  The user being
  413.       searched  for  does not need to be logged in;  however,  you
  414.       must be logged in to use this command.
  415.  
  416.  See Also:  IsUserLoggedIn?, IsUserDuplicated?
  417.  
  418.  Example:
  419.  
  420.       :Start
  421.            @ECHO OFF
  422.            NOVBAT DoesUserExist? %1
  423.            If ErrorLevel 255 goto Error
  424.            If ErrorLevel 1 goto Exists
  425.  
  426.       :NotExist
  427.            ECHO Sorry, But No User by that name on this Net.
  428.            goto End
  429.  
  430.       :Exists
  431.            ECHO Yes, That User has an Account.
  432.            goto End
  433.  
  434.       :Error
  435.            ECHO Sorry, but you not logged in I'm Afraid!
  436.       :End
  437.  
  438.  
  439.  
  440.  ______________________________________________________________________
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  IsAttached?
  467.  ______________________________________________________________________
  468.  
  469.  Function:  Verifies that user is attached to a specific server.
  470.  
  471.  Syntax:    NOVBAT  IsAttached?  ServerName
  472.  
  473.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  474.  
  475.  Remarks:
  476.  
  477.       Being "ATTACHED" to a file server does not mean that a  user
  478.       is  logged into that server.  The IsAttached?  command  will
  479.       indicate  if  a user is attached to any given  server  name.
  480.       The ServerName parameter is required and is not case  sensi-
  481.       tive.  You do not need to be logged into the server you  are
  482.       checking,  but  you do need to have IPX and your  Net  Shell
  483.       loaded to avoid an error.
  484.  
  485.  See Also:
  486.          IsDefaultServer?, IsPrimaryServer?, SetDefaultServer,
  487.          SetPrimaryServer
  488.  
  489.  Example:
  490.  
  491.       :Start
  492.            NOVBAT IsAttached? ACCOUNTING
  493.            If ErrorLevel 255 goto Error
  494.            If ErrorLevel 1 goto FoundAccounting
  495.       :NoAccounting
  496.            ECHO Your not Attached to the ACCOUNTING Server.
  497.            goto End
  498.       :FoundAccounting
  499.            ECHO You Are Attached to the ACCOUNTING SERVER.
  500.            goto End
  501.       :Error
  502.            ECHO ERROR: Try loading your IPX & Net Shell!
  503.       :End
  504.  
  505.  
  506.  ______________________________________________________________________
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  IsCPU?
  533.  ______________________________________________________________________
  534.  
  535.  Function:  This command confirms your processor type.
  536.  
  537.  Syntax:    NOVBAT  IsCPU?  CPUName
  538.  
  539.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  540.  
  541.  Remarks:
  542.  
  543.       In some instances it is useful to confirm a user's processor
  544.       type.  You might want, for example, to install QEMM  on  all
  545.       the 386 systems on the net.  The IsCPU? command will  return
  546.       a true response only when the parameter CPUName matches  the
  547.       CPU  type of the system.  The legal options for CPUName  are
  548.       8088, 286, 386, and 486.  Any other string will generate  an
  549.       error  result code.  If you are using a V20, 8086, or  other
  550.       clone-type XT processor, it will be interpreted as an  8088.
  551.       The  parameter  CPUName is required.   SPECIAL  NOTE:   This
  552.       command  does not require Netware and can be used in a  non-
  553.       network environment.
  554.  
  555.  See Also:  SetCPU
  556.  
  557.  Example:
  558.  
  559.       :Start
  560.            @ECHO OFF
  561.            NOVBAT IsCPU? 386
  562.            If ErrorLevel 1 goto GoQEMM
  563.            NOVBAT IsCPU? 486
  564.            If ErrorLevel 1 goto GoQEMM
  565.       :NoQEMM
  566.            goto End
  567.       :GOQEMM
  568.            CALL GOQEMM.BAT
  569.       :End
  570.  
  571.  
  572.  ______________________________________________________________________
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  IsDefaultServer?
  599.  ______________________________________________________________________
  600.  
  601.  Function:  This command verifies your default server.
  602.  
  603.  Syntax:    NOVBAT  IsDefaultServer?  ServerName
  604.  
  605.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  606.  
  607.  Remarks:
  608.  
  609.       There  are  times  when it is useful to  confirm  that  your
  610.       default  server  is a specific server.  This  is  especially
  611.       important  in  a multiserver environment.  The  use  of  the
  612.       IsDefaultServer? command makes this possible.  The parameter
  613.       ServerName is required.
  614.  
  615.  See Also:
  616.          IsAttached?, IsPrimaryServer?, SetDefaultServer,
  617.          SetPrimaryServer
  618.  
  619.  Example:
  620.  
  621.       :Start
  622.            @ECHO OFF
  623.            NOVBAT IsDefaultServer? ENGINEERING
  624.            If ErrorLevel 255 goto Error
  625.            If ErrorLevel 1 goto Confirmed
  626.  
  627.       :NotConfirmed
  628.            ECHO ENGINEERING isn't your current default server.
  629.            goto End
  630.  
  631.       :Confirmed
  632.            ECHO Yes, ENGINEERING is your current default server.
  633.            goto End
  634.  
  635.       :Error
  636.            ECHO ERROR: Try loading your IPX & Net Shell!
  637.       :End
  638.  ______________________________________________________________________
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  IsDOSVer?
  665.  ______________________________________________________________________
  666.  
  667.  Function:  Verifies your DOS version number.
  668.  
  669.  Syntax:    NOVBAT  IsDOSVer?  VersionNum
  670.  
  671.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  672.  
  673.  Remarks:
  674.  
  675.       If  you  operate in an environment  that  supports  multiple
  676.       versions  of DOS, it can be useful to verify your  DOS  ver-
  677.       sion.   The  IsDOSVer? command does  this.   The  VersionNum
  678.       parameter  requires  that the version  number  be  expressed
  679.       without use of the period.  For Example, if you are  testing
  680.       for  DOS  3.30 then you must express  VersionNum  as  "330".
  681.       This command only returns true when you have an exact  match
  682.       on the DOS version number.  SPECIAL NOTE:  This command does
  683.       not  require Netware and can be used in a non-network  envi-
  684.       ronment.
  685.  
  686.  See Also:  IsDOSVerSince?, SetDOSVer
  687.  
  688.  Example:
  689.  
  690.       :Start
  691.            NOVBAT IsDOSVer? 401
  692.            If ErrorLevel 255 goto Error
  693.            If ErrorLevel 1 goto Running401
  694.       :Opps
  695.            ECHO Sorry, you need DOS 4.01 for this option.
  696.            goto End
  697.       :Running401
  698.            ECHO DOS 4.01 Confirmed.  Please hold for access.
  699.            ; Access to application goes here!
  700.            goto End
  701.       :Error
  702.            ECHO ERROR: Illegal parameter syntax!
  703.       :End
  704.  ______________________________________________________________________
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  IsDOSVerSince?
  731.  ______________________________________________________________________
  732.  
  733.  Function:  Confirms your DOS is as recent as specified version.
  734.  
  735.  Syntax:    NOVBAT  IsDOSVerSince?  VersionNum
  736.  
  737.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  738.  
  739.  Remarks:
  740.  
  741.       Some  applications  require that your version of DOS  be  at
  742.       least  as  recent  as a specific version.   In  a  multi-DOS
  743.       environment it is sometimes important to insure that a  user
  744.       is  running  a version of DOS that is at least as new  as  a
  745.       specified  version.  The parameter VersionNum requires  that
  746.       the  period  be dropped (See the IsDOSVer?  command).   This
  747.       command returns True if the current version of DOS is  equal
  748.       to or newer than the specified version.  SPECIAL NOTE:  This
  749.       command  does not require Netware and can be used in a  non-
  750.       network environment.
  751.  
  752.  See Also:  IsDOSVer?, SetDOSVer
  753.  
  754.  Example:
  755.  
  756.       :Start
  757.            NOVBAT IsDOSVerSince? 300
  758.            If ErrorLevel 255 goto Error
  759.            If ErrorLevel 1 goto AtLeast3
  760.       :NotRightDos
  761.            ECHO Sorry, You need DOS 3.00 or newer for this option.
  762.            goto End
  763.       :AtLeast3
  764.            ECHO DOS 3.00 or newer confirmed, hold for access.
  765.            ; Access to application goes here!
  766.            goto End
  767.       :Error
  768.            ECHO ERROR: Illegal parameter syntax!
  769.       :End
  770.  ______________________________________________________________________
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  IsFreeEMS@Least?
  797.  ______________________________________________________________________
  798.  
  799.  Function:  This command confirms the amount of available EMS RAM.
  800.  
  801.  Syntax:    NOVBAT  IsFreeEMS@Least?  NumberOfK
  802.  
  803.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  804.  
  805.  Remarks:
  806.  
  807.       Since  some applications need to use EMS memory, it  can  be
  808.       useful  to  check  to insure that enough  EMS  is  currently
  809.       available  for certain programs.  This command returns  true
  810.       if  the  amount of EMS available is at least  equal  to  the
  811.       parameter  NumberOfK. SPECIAL NOTE:  This command  does  not
  812.       require  Netware and can be used in a  non-network  environ-
  813.       ment.
  814.  
  815.  See Also:  IsTotalEMS@Least?, SetFreeEMS, SetTotalEMS
  816.  
  817.  Example:
  818.  
  819.       :Start
  820.            NOVBAT IsFreeEMS@Least? 145
  821.            If ErrorLevel 255 goto Error
  822.            If ErrorLevel 1 goto GotEMS
  823.  
  824.       :NotEnoughEMS
  825.            ECHO Sorry, You need more EMS Memory to use SwapSK.
  826.            goto End
  827.  
  828.       :GotEMS
  829.            ECHO Sufficient EMS confirmed, hold for SWAPSK.
  830.            SwapSK         ;Puts Sidekick into EMS memory!
  831.            goto End
  832.  
  833.       :Error
  834.            ECHO ERROR: Illegal parameter syntax!
  835.       :End
  836.  ______________________________________________________________________
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  IsFreeRAM@Least?
  863.  ______________________________________________________________________
  864.  
  865.  Function:  This command confirms the amount of unused system RAM.
  866.  
  867.  Syntax:    NOVBAT  IsFreeRAM@Least?  NumberOfK
  868.  
  869.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  870.  
  871.  Remarks:
  872.  
  873.       With  heavy  use of TSR programs,  sometimes  there  is  not
  874.       enough  unused  system RAM for larger programs  to  function
  875.       properly. The IsFreeRAM@Least? command verifies that  suffi-
  876.       cient  RAM is available before you execute a given  applica-
  877.       tion.  This command returns true if the amount of unused RAM
  878.       is at least equal to the parameter NumberOfK.  SPECIAL NOTE:
  879.       This  command does not require Netware and can be used in  a
  880.       non-network environment.
  881.  
  882.  See Also:  IsTotalRAM@Least?, SetFreeRAM, SetTotalRAM
  883.  
  884.  Example:
  885.  
  886.       :Start
  887.            @ECHO OFF
  888.            NOVBAT IsFreeRAM@Least? 512
  889.            If ErrorLevel 255 goto Error
  890.            If ErrorLevel 1 goto GotRAM
  891.       :NotEnoughRAM
  892.            ECHO Not Enough Memory, Try Unloading some TSR's!
  893.            goto End
  894.       :GotRAM
  895.            ECHO Loading... Please wait..
  896.            BigProgram.exe    ;Execute Application
  897.            goto End
  898.       :Error
  899.            ECHO ERROR: Illegal parameter syntax!
  900.       :End
  901.  
  902.  ______________________________________________________________________
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  IsFullName?
  929.  ______________________________________________________________________
  930.  
  931.  Function:  This command verifies your full Novell User Name.
  932.  
  933.  Syntax:    NOVBAT  IsFullName?  FullNameString  [UserName]
  934.  
  935.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  936.  
  937.  Remarks:
  938.  
  939.       This  command is used to verify the full name of  any  user.
  940.       There  are  two possible parameters for this  command.   The
  941.       first  parameter,  FullNameString, is required  and  is  the
  942.       Novell full name of a user as defined by SYSCON.  The second
  943.       parameter is optional and specifies which user to check  the
  944.       full name against; if absent then the current user <Self> is
  945.       assumed.  When specifying the full name, replace any  embed-
  946.       ded  spaces with the underline "_" character.   For  example
  947.       the name "George Bush" should be expressed as "George_Bush".
  948.       This  command only returns true if the full name compare  is
  949.       an exact match.  The name compare is not case-sensitive.
  950.  
  951.  See Also:  SetFullName
  952.  
  953.  Example:
  954.       :Start
  955.            NOVBAT IsFullName? "George_Herbert_Walker_Bush"
  956.            If ErrorLevel 255 goto Error
  957.            If ErrorLevel 1 goto Confirmed
  958.       :NotThePresident
  959.            ECHO Access restricted to the Presidents Eyes Only!
  960.            goto End
  961.       :Confirmed
  962.            ECHO Thank you Mr. President.
  963.            PORKBARL.EXE    ;Execute Application
  964.            goto End
  965.       :Error
  966.            ECHO ERROR: Illegal parameter syntax!
  967.       :End
  968.  ______________________________________________________________________
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  IsMailID?
  995.  ______________________________________________________________________
  996.  
  997.  Function:  This command verifies your Novell Mail User ID.
  998.  
  999.  Syntax:    NOVBAT  IsMailID?  MailIDString  UserName
  1000.  
  1001.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  1002.  
  1003.  Remarks:
  1004.  
  1005.       This  command  is used to verify the Novell Mail ID  of  any
  1006.       user.   There are two possible parameters for this  command.
  1007.       The  first parameter, MailIDString, is required and  is  the
  1008.       actual Mail ID of a user.  The second parameter is  optional
  1009.       and  specifies  which  user  to check  the  Mail  ID  String
  1010.       against;  if absent then this user <Self> is assumed.   This
  1011.       command  only returns true if the Mail ID string compare  is
  1012.       an exact match.  The name compare is not case-sensitive.
  1013.  
  1014.  See Also:  SetMailID
  1015.  
  1016.  Example:
  1017.  
  1018.       :Start
  1019.            NOVBAT IsMailID? 1
  1020.            If ErrorLevel 255 goto Error
  1021.            If ErrorLevel 1 goto Confirmed
  1022.  
  1023.       :NotTheSupervisor
  1024.            ECHO Sorry, Supervisor Access Only!
  1025.            goto End
  1026.  
  1027.       :Confirmed
  1028.            SYSCON.EXE    ;Execute Application
  1029.            goto End
  1030.  
  1031.       :Error
  1032.            ECHO ERROR: Illegal parameter syntax!
  1033.       :End
  1034.  ______________________________________________________________________
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  IsMaxUsers?
  1061.  ______________________________________________________________________
  1062.  
  1063.  Function:  Verifies Max. number of users allowed by your Netware.
  1064.  
  1065.  Syntax:    NOVBAT  IsMaxUsers?  Number
  1066.  
  1067.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  1068.  
  1069.  Remarks:
  1070.  
  1071.       This  command allows you to determine the maximum number  of
  1072.       users  your  version of Netware  can  concurrently  support.
  1073.       Netware  is sold in versions that support a wide  number  of
  1074.       users;  with this NovBat command you can conveniently  check
  1075.       this limit.  The parameter Number is required.
  1076.  
  1077.  See Also:  IsUsers@Least?, SetMaxUsers, SetUsersLoggedIn
  1078.  
  1079.  Example:
  1080.  
  1081.       :Start
  1082.            NOVBAT IsMaxUsers? 250
  1083.            If ErrorLevel 1 goto WayToGo
  1084.            NOVBAT IsMaxUsers? 100
  1085.            If ErrorLevel 1 goto NotBad
  1086.       :CouldBeBetter
  1087.            ECHO Next time get a bigger Network!
  1088.            goto End
  1089.       :WayToGo
  1090.            ECHO All Right!  Now thats real power!
  1091.            goto End
  1092.       :NotBad
  1093.            ECHO Looks like a pretty good situtation.
  1094.       :End
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  ______________________________________________________________________
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  IsMessageMode?
  1127.  ______________________________________________________________________
  1128.  
  1129.  Function:  Verifies your current Message Receive Mode.
  1130.  
  1131.  Syntax:    NOVBAT  IsMessageMode?  ModeType
  1132.  
  1133.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  1134.  
  1135.  Remarks:
  1136.  
  1137.       The  Netware SEND command allows users to send  messages  to
  1138.       each  other, and receiving users have the ability  to  block
  1139.       incoming  messages.  The IsMessageMode? command will  verify
  1140.       which  receive mode you are in. The modes are:  "ALL"  where
  1141.       all  messages  are  displayed, "SERVER"  where  only  server
  1142.       messages  are  accepted, and "NONE" where  no  messages  are
  1143.       accepted.  The parameter ModeType must be set to either ALL,
  1144.       SERVER, or NONE.
  1145.  
  1146.  See Also:  SetMessageMode
  1147.  
  1148.  Example:
  1149.  
  1150.       :Start
  1151.            NOVBAT IsMessageMode? ALL
  1152.            If ErrorLevel 1 goto ModeAll
  1153.            NOVBAT IsMessageMode? SERVER
  1154.            If ErrorLevel 1 goto ModeServer
  1155.       :ModeNone
  1156.            ECHO No messages are currently being accepted.
  1157.            goto End
  1158.       :ModeAll
  1159.            ECHO All messages are being accepted.
  1160.            goto End
  1161.       :ModeServer
  1162.            ECHO Only SERVER messages are being accepted.
  1163.            goto End
  1164.       :End
  1165.  
  1166.  ______________________________________________________________________
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  IsNetNum?
  1193.  ______________________________________________________________________
  1194.  
  1195.  Function:  Verifies the network number you are connected to.
  1196.  
  1197.  Syntax:    NOVBAT  IsNetNum?  Number
  1198.  
  1199.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  1200.  
  1201.  Remarks:
  1202.  
  1203.       The  IsNetNum? command is used to verify the network  number
  1204.       you  are connected to.  Many large companies  have  multiple
  1205.       nets with a common backbone.  In this environment you  might
  1206.       want  to restrict users to accessing certain functions  from
  1207.       some nets and not others.  The parameter Number must be from
  1208.       1 to 255.
  1209.  
  1210.  See Also:  IsNodeNum?, IsStationAddress?, SetNetNum, SetNodeNum,
  1211.             SetStationAddress
  1212.  
  1213.  Example:
  1214.  
  1215.       :Start
  1216.            NOVBAT IsNetNum? 254
  1217.            If ErrorLevel 255 goto Error
  1218.            If ErrorLevel 1 goto HomeNet
  1219.  
  1220.       :NotOnHomeNet
  1221.            ECHO Please return to your home net for this option.
  1222.            goto End
  1223.  
  1224.       :HomeNet
  1225.            EMAIL
  1226.            goto End
  1227.  
  1228.       :Error
  1229.            ECHO ERROR: Try Logging in first.
  1230.       :End
  1231.  
  1232.  ______________________________________________________________________
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  IsNetwareVer?
  1259.  ______________________________________________________________________
  1260.  
  1261.  Function:  Verifies your Novell Netware version number .
  1262.  
  1263.  Syntax:    NOVBAT  IsNetwareVer?  VersionNum
  1264.  
  1265.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  1266.  
  1267.  Remarks:
  1268.  
  1269.       In  a  large multi-lan environment it is possible to  be  to
  1270.       attached to several servers with multiple versions of Novell
  1271.       Netware.   There  are times when it might be  convenient  to
  1272.       verify  which  version of Netware you are  currently  using.
  1273.       The  IsNetwareVer? command does this.  Please note that  the
  1274.       parameter  VersionNum is a Netware version number  expressed
  1275.       without any periods.  For example, Netware 3.11 needs to  be
  1276.       expressed as 311.
  1277.  
  1278.  See Also:  SetNetwareVer
  1279.  
  1280.  Example:
  1281.  
  1282.       :Start
  1283.            NOVBAT IsNetwareVer? 311
  1284.            If ErrorLevel 1 goto Best
  1285.            NOVBAT IsNetwareVer? 215
  1286.            If ErrorLevel 1 goto Better
  1287.       :ModeOK
  1288.            ECHO Running Netware.
  1289.            goto End
  1290.       :Better
  1291.            ECHO Running Netware 2.15.
  1292.            goto End
  1293.       :Best
  1294.            ECHO Running Netware 386 Ver 3.11.
  1295.       :End
  1296.  
  1297.  
  1298.  ______________________________________________________________________
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  IsNodeNum?
  1325.  ______________________________________________________________________
  1326.  
  1327.  Function:  This command verifies your station's node number.
  1328.  
  1329.  Syntax:    NOVBAT  IsNodeNum?  Number
  1330.  
  1331.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  1332.  
  1333.  Remarks:
  1334.  
  1335.       There are times when, for security reasons, you may want  to
  1336.       verify  that a user is logged into a  specific  workstation.
  1337.       The IsNodeNum? command provides a mechanism for  accomplish-
  1338.       ing this.  The parameter Number is the node number to  test.
  1339.       Please  note  that  the Number parameter  is  a  Hexadecimal
  1340.       number, not decimal.
  1341.  
  1342.  See Also:  IsNetNum?, IsStationAddress?, SetNetNum, SetNodeNum,
  1343.             SetStationAddress
  1344.  
  1345.  Example:
  1346.  
  1347.       :Start
  1348.            NOVBAT IsNodeNum? 15
  1349.            If ErrorLevel 255 goto Error
  1350.            If ErrorLevel 1 goto HomeStation
  1351.  
  1352.       :NotAtHome
  1353.            ECHO You must be at YOUR workstation to access EMAIL.
  1354.            goto End
  1355.  
  1356.       :HomeStation
  1357.            EMAIL.EXE     ;Access Application
  1358.            goto End
  1359.  
  1360.       :Error
  1361.            ECHO ERROR: Invalid Parameter.
  1362.       :End
  1363.  
  1364.  ______________________________________________________________________
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  IsPrimaryServer?
  1391.  ______________________________________________________________________
  1392.  
  1393.  Function:  This command verifies the name of your primary server.
  1394.  
  1395.  Syntax:    NOVBAT  IsPrimaryServer?  ServerName
  1396.  
  1397.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  1398.  
  1399.  Remarks:
  1400.  
  1401.       In larger Multi-Server corporations, some users will  access
  1402.       several  file servers in a single operating session.  It  is
  1403.       useful to be able to verify that their Primary server is the
  1404.       expected  server.  The required parameter ServerName is  the
  1405.       Name  string of the server to test; if absent an error  will
  1406.       result.
  1407.  
  1408.  See Also:  IsAttached?, IsDefaultServer?, SetDefaultServer,
  1409.             SetPrimaryServer
  1410.  
  1411.  Example:
  1412.  
  1413.       :Start
  1414.            @ECHO OFF
  1415.            NOVBAT IsPrimaryServer? HORIZONS
  1416.            If ErrorLevel 255 goto Error
  1417.            If ErrorLevel 1 goto OnHorizons
  1418.  
  1419.       :NotHorizons
  1420.            ECHO Primary Server isn't HORIZONS. Please correct.
  1421.            goto End
  1422.  
  1423.       :OnHorizons
  1424.            ECHO Thank You.  You are on server: HORIZONS.
  1425.            goto End
  1426.  
  1427.       :Error
  1428.            ECHO ERROR: Invalid Parameter(s)!
  1429.       :End
  1430.  ______________________________________________________________________
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  IsSecurityEquiv?
  1457.  ______________________________________________________________________
  1458.  
  1459.  Function:  This command compares your security equivalences.
  1460.  
  1461.  Syntax:    NOVBAT  IsSecurityEquiv?  GroupOrUser  UserName
  1462.  
  1463.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  1464.  
  1465.  Remarks:
  1466.  
  1467.       It can be useful to verify if a user has a particular  secu-
  1468.       rity equivalence.  You might want only supervisor equivalent
  1469.       users  to  have a menu option to run  SYSCON,  for  example.
  1470.       This command allows you to verify if a user is equivalent to
  1471.       another  user  or a group.  This command  has  one  required
  1472.       parameter  GroupOrUser and one optional parameter  UserName.
  1473.       If the UserName parameter is missing then NovBat will assume
  1474.       the current user <Self>.
  1475.  
  1476.  See Also:  None
  1477.  
  1478.  Example:
  1479.  
  1480.       :Start
  1481.            NOVBAT IsSecurityEquiv? Supervisor %1
  1482.            If ErrorLevel 255 goto Error
  1483.            If ErrorLevel 1 goto GoSup
  1484.  
  1485.       :NotSup
  1486.            ECHO No, that user is not Supervisor Equivalent.
  1487.            goto End
  1488.  
  1489.       :GoSup
  1490.            ECHO Yes, that user is Supervisor Equivalent.
  1491.            goto End
  1492.  
  1493.       :Error
  1494.            ECHO ERROR: Are you logged in?
  1495.       :End
  1496.  ______________________________________________________________________
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  IsStationAddress?
  1523.  ______________________________________________________________________
  1524.  
  1525.  Function:  This command verifies your computer's station address.
  1526.  
  1527.  Syntax:    NOVBAT  IsStationAddress?  AddressString
  1528.  
  1529.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  1530.  
  1531.  Remarks:
  1532.  
  1533.       The IsStationAddress? command will verify your workstation's
  1534.       address  against  the  address specified  in  the  parameter
  1535.       AddressString.   The syntax for this required  parameter  is
  1536.       Network number:Node number.  The Node number portion of  the
  1537.       argument needs to be expressed as a Hexadecimal number.  For
  1538.       example, if you are connected to Network # 250 and your Node
  1539.       number  is 100 decimal, then the proper syntax for  Address-
  1540.       String is 250:64.
  1541.  
  1542.  See Also:  IsNetNum?, IsNodeNum?, SetNetNum, SetNodeNum,
  1543.             SetStationAddress
  1544.  
  1545.  Example:
  1546.  
  1547.       :Start
  1548.            @ECHO OFF
  1549.            NOVBAT IsStationAddress? 254:5
  1550.            If ErrorLevel 255 goto Error
  1551.            If ErrorLevel 1 goto AtHome
  1552.       :NotAtHome
  1553.            ECHO Please return to your desk before using EMAIL.
  1554.            goto End
  1555.       :AtHome
  1556.            EMAIL.EXE      ;Execute Application
  1557.            goto End
  1558.       :Error
  1559.            ECHO ERROR: Please Login before sending EMAIL!
  1560.       :End
  1561.  
  1562.  ______________________________________________________________________
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  IsTotalEMS@Least?
  1589.  ______________________________________________________________________
  1590.  
  1591.  Function:  Confirms the amount of EMS RAM your workstation has.
  1592.  
  1593.  Syntax:    NOVBAT  IsTotalEMS@Least?  NumberOfK
  1594.  
  1595.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  1596.  
  1597.  Remarks:
  1598.  
  1599.       Since some applications can take advantage of EMS memory, it
  1600.       can  be  useful to verify if a  given  workstation  contains
  1601.       enough  EMS to execute certain applications.   This  command
  1602.       returns  true  if the amount of EMS installed  is  at  least
  1603.       equal  to  the parameter NumberOfK.  This command  does  not
  1604.       insure  that  the EMS memory is currently  unused  by  other
  1605.       applications.  SPECIAL NOTE:  This command does not  require
  1606.       Netware and can be used in a non-network environment.
  1607.  
  1608.  See Also:  IsFreeEMS@Least?, SetFreeEMS, SetTotalEMS
  1609.  
  1610.  Example:
  1611.  
  1612.       :Start
  1613.            @ECHO OFF
  1614.            NOVBAT IsTotalEMS@Least? 1
  1615.            If ErrorLevel 255 goto Error
  1616.            If ErrorLevel 1 goto GotEMS
  1617.       :NoEMS
  1618.            ECHO Sorry, You need EMS Memory to use this Program.
  1619.            goto End
  1620.       :GotEMS
  1621.            ECHO EMS Memory Present, please hold.
  1622.            EMSAPP.EXE         ;Application requiring EMS
  1623.            goto End
  1624.       :Error
  1625.            ECHO ERROR: Illegal parameter syntax!
  1626.       :End
  1627.  
  1628.  ______________________________________________________________________
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  IsTotalRAM@Least?
  1655.  ______________________________________________________________________
  1656.  
  1657.  Function:  Confirms the amount of system RAM your system has.
  1658.  
  1659.  Syntax:    NOVBAT  IsTotalRAM@Least?  NumberOfK
  1660.  
  1661.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  1662.  
  1663.  Remarks:
  1664.  
  1665.       Since some applications require large amounts of system RAM,
  1666.       it  can be useful to verify if a given workstation  contains
  1667.       enough RAM before attempting to execute these programs.  The
  1668.       IsTotalRAM@Least?  command  returns true if  the  amount  of
  1669.       system  RAM  installed is at least equal  to  the  parameter
  1670.       NumberOfK.   This  command does not insure that the  RAM  is
  1671.       currently unused by other applications.  SPECIAL NOTE:  This
  1672.       command  does not require Netware and can be used in a  non-
  1673.       network environment.
  1674.  
  1675.  See Also:  IsFreeRAM@Least?, SetFreeRAM, SetTotalRAM
  1676.  
  1677.  Example:
  1678.  
  1679.       :Start
  1680.            @ECHO OFF
  1681.            NOVBAT IsTotalRAM@Least? 512
  1682.            If ErrorLevel 255 goto Error
  1683.            If ErrorLevel 1 goto GotLotsOfRam
  1684.       :NotEnoughRam
  1685.            ECHO You need at least 512k of Ram for this Program.
  1686.            goto End
  1687.       :GotLotsOfRam
  1688.            BIGPRGM.EXE    ;App requiring at least 512k of RAM.
  1689.            goto End
  1690.       :Error
  1691.            ECHO ERROR: Illegal parameter syntax!
  1692.       :End
  1693.  
  1694.  ______________________________________________________________________
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  IsUserDuplicated?
  1721.  ______________________________________________________________________
  1722.  
  1723.  Function:  Indicates if user is logged into more than 1 station.
  1724.  
  1725.  Syntax:    NOVBAT  IsUserDuplicated?  UserName
  1726.  
  1727.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  1728.  
  1729.  Remarks:
  1730.  
  1731.       The IsUserDuplicated? command can be used to restrict  users
  1732.       from  logging into multiple workstations without first  log-
  1733.       ging  off  of  their previous system.   The  security  risks
  1734.       associated  with  a user leaving workstations logged  in  is
  1735.       obvious.   The parameter UserName is optional but if present
  1736.       should  be  a valid user name.  If absent the  current  user
  1737.       <Self> is assumed. This command returns True if the user  in
  1738.       question is currently logged into two or more workstations.
  1739.  
  1740.  See Also:  IsUserLoggedIn?
  1741.  
  1742.  Example:
  1743.  
  1744.       ; Portion of a possible login Script
  1745.            NOVBAT SetUserName Name
  1746.            NOVBAT IsUserDuplicated? %Name%
  1747.            If ErrorLevel 255 goto Error
  1748.            If ErrorLevel 1 goto TwoMany
  1749.       :AllsFine
  1750.            goto ExitScript
  1751.       :TwoMany
  1752.            ECHO Sorry, already logged into another computer.
  1753.            ECHO You must logoff the previous system before logging
  1754.            ECHO into this system.
  1755.            goto ExitScript
  1756.       :Error
  1757.            ECHO NOVBAT Error: Report it to system Supervisor!
  1758.       :ExitScript
  1759.  
  1760.  ______________________________________________________________________
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  IsUserLoggedIn?
  1787.  ______________________________________________________________________
  1788.  
  1789.  Function:  Indicates if a particular user is currently logged in.
  1790.  
  1791.  Syntax:    NOVBAT  IsUserLoggedIn?  UserName
  1792.  
  1793.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  1794.  
  1795.  Remarks:
  1796.  
  1797.       This  command is used to determine if the user indicated  by
  1798.       the UserName parameter is currently logged into the network.
  1799.       If this parameter is missing then the current user <Self> is
  1800.       assumed.
  1801.  
  1802.  See Also:  IsUserDuplicated?
  1803.  
  1804.  Example:
  1805.  
  1806.       :Start
  1807.            @ECHO OFF
  1808.            NOVBAT IsUserLoggedIn? %1
  1809.       If ErrorLevel 255 goto Error
  1810.            If ErrorLevel 1 goto YesGotUser
  1811.  
  1812.       :NoUserIsNotOnLine
  1813.            ECHO Sorry, that User Is Not Available At this Time.
  1814.            goto End
  1815.  
  1816.       :YesGotUser
  1817.            send %1 %2
  1818.            goto End
  1819.  
  1820.       :Error
  1821.            ECHO Error: You must be logged in to use this command.
  1822.       :End
  1823.  
  1824.  
  1825.  
  1826.  ______________________________________________________________________
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  IsUserName?
  1853.  ______________________________________________________________________
  1854.  
  1855.  Function:  This command verifies your user name.
  1856.  
  1857.  Syntax:    NOVBAT  IsUserName?  UserName
  1858.  
  1859.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  1860.  
  1861.  Remarks:
  1862.  
  1863.       The  parameter UserName is required.  This  command  returns
  1864.       True  only  if  the user name of the current  user  and  the
  1865.       parameter are an exact match.  The name compare is not case-
  1866.       sensitive.
  1867.  
  1868.  See Also:  SetUserName
  1869.  
  1870.  Example:
  1871.  
  1872.       :Start
  1873.            @ECHO OFF
  1874.            NOVBAT IsUserName? FAX
  1875.       If ErrorLevel 255 goto Error
  1876.       If ErrorLevel 1 goto IsFax
  1877.  
  1878.       :NotFax
  1879.            ECHO Sorry, This program can only be executed by the
  1880.            ECHO             automatic FAX server.
  1881.            goto End
  1882.  
  1883.       :IsFax
  1884.            FAXPURGE.EXE        ;Application Goes Here
  1885.            goto End
  1886.  
  1887.       :Error
  1888.            ECHO NovBat Error: Report it to system Supervisor!
  1889.       :End
  1890.  
  1891.  
  1892.  ______________________________________________________________________
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  IsUsers@Least?
  1919.  ______________________________________________________________________
  1920.  
  1921.  Function:  Confirms number of users currently logged into net.
  1922.  
  1923.  Syntax:    NOVBAT  IsUsers@Least?  Number
  1924.  
  1925.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  1926.  
  1927.  Remarks:
  1928.  
  1929.       This  command  is used to confirm that the number  of  users
  1930.       logged  into the network is above a minimum  threshold.   By
  1931.       Starting  with a larger threshold and working down,  network
  1932.       usage  can  be  categorized.  This  condition  returns  True
  1933.       whenever the number of users logged into the Net is at least
  1934.       equal to the parameter Number.
  1935.  
  1936.  See Also:  SetUsersLoggedIn
  1937.  
  1938.  Example:
  1939.  
  1940.       :Start
  1941.            NOVBAT IsUsers@Least? 200
  1942.            If ErrorLevel 1 goto Heavy
  1943.            NOVBAT IsUsers@Least 100
  1944.            If ErrorLevel 1 goto Moderate
  1945.  
  1946.       :Light
  1947.            ECHO Network Usage is currently light. (< 100 Users)
  1948.            goto End
  1949.  
  1950.       :Heavy
  1951.            ECHO Network Usage is Heavy. ( 200 and >)
  1952.            goto End
  1953.  
  1954.       :Moderate
  1955.            ECHO Network Usage is Moderate. (100-200 Users)
  1956.            goto End
  1957.       :End
  1958.  ______________________________________________________________________
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  IsVideo?
  1985.  ______________________________________________________________________
  1986.  
  1987.  Function:  This command verifies your Graphics Adapter Type.
  1988.  
  1989.  Syntax:    NOVBAT  IsVideo?  VideoType
  1990.  
  1991.  Response Type:  ERRORLEVEL  (Codes: 1=True, 0=False, 255=Error)
  1992.  
  1993.  Remarks:
  1994.  
  1995.       Since  different workstations on the net will  have  varying
  1996.       display adapters, it can be useful to determine which adapt-
  1997.       er type a particular system has for the purpose of selecting
  1998.       the correct software drivers for that system.  This  command
  1999.       compares  the adapter type to the current system,  returning
  2000.       True if there is a match.  The legal options for the  Video-
  2001.       Type  parameter  are MGA or HERC, CGA, MCGA, EGA,  VGA,  and
  2002.       PGA.   Any  other string will generate  an  error.   SPECIAL
  2003.       NOTE:  This command does not require Netware and can be used
  2004.       in a non-network environment.
  2005.  
  2006.  See Also:  SetVideo
  2007.  
  2008.  Example:
  2009.  
  2010.       :Start
  2011.            @ECHO OFF
  2012.            NOVBAT IsVideo? MGA
  2013.            If ErrorLevel 255 goto Error
  2014.            If ErrorLevel 1 goto Mono
  2015.       :Color
  2016.            SPREAD_C.EXE   ;Color Configured Version of Program.
  2017.            goto End
  2018.       :Mono
  2019.            SPREAD_M.EXE   ;Mono Configured Version of Program.
  2020.            goto End
  2021.       :Error
  2022.            ECHO NovBat Error: Illegal Parameter!
  2023.       :End
  2024.  ______________________________________________________________________
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  SetCPU
  2051.  ______________________________________________________________________
  2052.  
  2053.  Function:   Sets an environment variable to the type of  CPU.
  2054.  
  2055.  Syntax:    NOVBAT  SetCPU  [VarName]
  2056.  
  2057.  Response Type:  ENVIRONMENT
  2058.  
  2059.  Remarks:
  2060.  
  2061.       This  command stores your processor type into the  specified
  2062.       environment  variable.   The  possible  result  strings  are
  2063.       8088,  286, 386, and 486.  SPECIAL NOTE:  This command  does
  2064.       not  require Netware and can be used in a non-network  envi-
  2065.       ronment.
  2066.  
  2067.  See Also:  IsCPU?
  2068.  
  2069.  Example:
  2070.  
  2071.       :Start
  2072.            @ECHO OFF
  2073.            NOVBAT SetCPU CPU
  2074.            If ErrorLevel 255 goto Error
  2075.            NOVBAT SetName
  2076.            If ErrorLevel 255 goto Error
  2077.            ECHO ------------------------------------------
  2078.            ECHO User: %NovBat% - Using a %CPU%.
  2079.            ECHO ------------------------------------------
  2080.            set CPU=
  2081.            set NovBat=
  2082.            goto End
  2083.  
  2084.       :Error
  2085.            ECHO NovBat Error: Alert your system supervisor!
  2086.  
  2087.       :End
  2088.  
  2089.  
  2090.  ______________________________________________________________________
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  SetDefaultServer
  2117.  ______________________________________________________________________
  2118.  
  2119.  Function:  Sets environment variable to name of default server.
  2120.  
  2121.  Syntax:    NOVBAT  SetDefaultServer  [VarName]
  2122.  
  2123.  Response Type:  ENVIRONMENT
  2124.  
  2125.  Remarks:
  2126.  
  2127.       This  command  reads  the name of your  default  server  and
  2128.       places  it  into  an environment  variable  called  "NOVBAT"
  2129.       unless you have specified the optional VarName parameter  in
  2130.       which  case  the  variable name will  match  the  parameter.
  2131.       Sufficient environment space needs to be available to  avoid
  2132.       an  error.   If enough environment space  is  not  available
  2133.       NovBat  will display a warning indicating so and  abort  the
  2134.       command  without attempting to write the new data  into  the
  2135.       environment.  Any previous data in the environment with  the
  2136.       same name will be lost.
  2137.  
  2138.  See Also:  IsDefaultServer?, IsPrimaryServer?, SetPrimaryServer
  2139.  
  2140.  Example:
  2141.  
  2142.       :Start
  2143.            NOVBAT SetUserName Name
  2144.            If ErrorLevel 255 goto Error
  2145.            NOVBAT SetDefaultServer
  2146.            If ErrorLevel 255 goto Error
  2147.            ECHO -----------------------------------------------
  2148.            ECHO User: %Name% - Attached to server: %NovBat%.
  2149.            ECHO -----------------------------------------------
  2150.            set Name=
  2151.            set NovBat=
  2152.            goto End
  2153.       :Error
  2154.            ECHO NovBat Error: Alert your system supervisor!
  2155.       :End
  2156.  ______________________________________________________________________
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  SetDOSVer
  2183.  ______________________________________________________________________
  2184.  
  2185.  Function:  Sets environment variable to current DOS Ver. Number.
  2186.  
  2187.  Syntax:    NOVBAT  SetDOSVer  [VarName]
  2188.  
  2189.  Response Type:  ENVIRONMENT
  2190.  
  2191.  Remarks:
  2192.  
  2193.       This command places your current DOS version number into  an
  2194.       environment  variable.  Note that the period in the  version
  2195.       number  is  dropped.  If your DOS is version 5.00  then  the
  2196.       environment variable will be set to 500. SPECIAL NOTE:  This
  2197.       command  does not require Netware and can be used in a  non-
  2198.       network environment.
  2199.  
  2200.  See Also:  IsDOSVer?, IsDOSVerSince?
  2201.  
  2202.  Example:
  2203.  
  2204.       :Start
  2205.            @ECHO OFF
  2206.            NOVBAT SetDosVer
  2207.            If ErrorLevel 255 goto Error
  2208.            ECHO -----------------------------------------------
  2209.            ECHO You are using DOS Version %NovBat%.
  2210.            ECHO -----------------------------------------------
  2211.            set NovBat=
  2212.            goto End
  2213.  
  2214.       :Error
  2215.            ECHO NovBat Error: Alert your system supervisor!
  2216.       :End
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  ______________________________________________________________________
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  SetFreeEMS
  2249.  ______________________________________________________________________
  2250.  
  2251.  Function:  Sets environment variable to amount of unused EMS RAM.
  2252.  
  2253.  Syntax:    NOVBAT  SetFreeEMS  [VarName]
  2254.  
  2255.  Response Type:  ENVIRONMENT
  2256.  
  2257.  Remarks:
  2258.  
  2259.       This command determines how many k of unused EMS RAM  exists
  2260.       in the workstation and sets an environment variable  accord-
  2261.       ingly.  SPECIAL NOTE:  This command does not require Netware
  2262.       and can be used in a non-network environment.
  2263.  
  2264.  See Also:  IsFreeEMS@Least?, IsTotalEMS@Least?, SetTotalEMS
  2265.  
  2266.  Example:
  2267.  
  2268.       :Start
  2269.            @ECHO OFF
  2270.            NOVBAT SetFreeEMS EMSAVAIL
  2271.            NOVBAT SetTotalEMS EMSTOTAL
  2272.            NOVBAT SetFreeRAM RAMAVAIL
  2273.            NOVBAT SetTotalRAM RAMTOTAL
  2274.  
  2275.            ECHO ---------------] Memory Summary [-----------------
  2276.            ECHO EMS:  %EMSTOTAL%, Avail: %EMSAVAIL%.
  2277.            ECHO RAM:  %RAMTOTAL%, Avail: %RAMTOTAL%.
  2278.            ECHO --------------------------------------------------
  2279.  
  2280.            set EMSAVAIL=
  2281.            set EMSTOTAL=
  2282.            set RAMAVAIL=
  2283.            set RAMTOTAL=
  2284.       :End
  2285.  
  2286.  
  2287.  
  2288.  ______________________________________________________________________
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  SetFreeRAM
  2315.  ______________________________________________________________________
  2316.  
  2317.  Function:  Sets environment variable to amount of unused RAM.
  2318.  
  2319.  Syntax:    NOVBAT  SetFreeRAM  [VarName]
  2320.  
  2321.  Response Type:  ENVIRONMENT
  2322.  
  2323.  Remarks:
  2324.  
  2325.       This  command  determines how many k of  unused  system  RAM
  2326.       exists  in the workstation and sets an environment  variable
  2327.       accordingly.   SPECIAL NOTE:  This command does not  require
  2328.       Netware and can be used in a non-network environment.
  2329.  
  2330.  See Also:  IsFreeRAM@Least?, IsTotalRAM@Least?, SetTotalRAM
  2331.  
  2332.  Example:
  2333.  
  2334.       :Start
  2335.            @ECHO OFF
  2336.            NOVBAT SetFreeEMS EMSAVAIL
  2337.            NOVBAT SetTotalEMS EMSTOTAL
  2338.            NOVBAT SetFreeRAM RAMAVAIL
  2339.            NOVBAT SetTotalRAM RAMTOTAL
  2340.  
  2341.            ECHO ---------------] Memory Summary [----------------
  2342.            ECHO EMS:  %EMSTOTAL%, Avail: %EMSAVAIL%.
  2343.            ECHO RAM:  %RAMTOTAL%, Avail: %RAMTOTAL%.
  2344.            ECHO -------------------------------------------------
  2345.  
  2346.            set EMSAVAIL=
  2347.            set EMSTOTAL=
  2348.            set RAMAVAIL=
  2349.            set RAMTOTAL=
  2350.       :End
  2351.  
  2352.  
  2353.  
  2354.  ______________________________________________________________________
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  SetFullName
  2381.  ______________________________________________________________________
  2382.  
  2383.  Function:  Sets environment variable to Netware full user name.
  2384.  
  2385.  Syntax:    NOVBAT  SetFullName  [VarName]
  2386.  
  2387.  Response Type:  ENVIRONMENT
  2388.  
  2389.  Remarks:
  2390.  
  2391.       This  command sets an environment variable to the full  user
  2392.       name.  Please note that all embedded spaces are converted to
  2393.       the  underline  "_" character.  For example  the  full  name
  2394.       "Christopher     M.     Columbus"    is     converted     to
  2395.       "CHRISTOPHER_M._COLUMBUS".
  2396.  
  2397.  See Also:  IsFullName?, SetUserName
  2398.  
  2399.  Example:
  2400.  
  2401.       :Start
  2402.            @ECHO OFF
  2403.            NOVBAT SetFullName FNAME
  2404.            If ErrorLevel 255 goto Error
  2405.  
  2406.            ECHO -----------------------------------------------
  2407.            ECHO Your Full UserName is: %FNAME%.
  2408.            ECHO -----------------------------------------------
  2409.  
  2410.            set FNAME=
  2411.            goto End
  2412.  
  2413.       :Error
  2414.            ECHO --------------------------------------------
  2415.            ECHO NovBat ERROR:  Alert your Lan Administrator!
  2416.            ECHO --------------------------------------------
  2417.       :End
  2418.  
  2419.  
  2420.  ______________________________________________________________________
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  SetMailID
  2447.  ______________________________________________________________________
  2448.  
  2449.  Function:  Sets environment variable to your user mail ID.
  2450.  
  2451.  Syntax:    NOVBAT  SetMailID  [VarName]
  2452.  
  2453.  Response Type:  ENVIRONMENT
  2454.  
  2455.  Remarks:
  2456.  
  2457.       When a user account is first created with Netware the system
  2458.       assigns a mail ID code.  A subdirectory off the \MAIL direc-
  2459.       tory  is  created for this user with the same name  as  this
  2460.       mail  ID.   Many software packages take  advantage  of  this
  2461.       unique directory provision of Netware to make user  specific
  2462.       temporary  files.   By using the SetMailID command  you  can
  2463.       take  advantage  of this feature of Netware  in  your  batch
  2464.       files and login scripts.  This command generates an environ-
  2465.       ment variable set to the unique user mail ID of the  current
  2466.       user.
  2467.  
  2468.  See Also:  IsMailID?
  2469.  
  2470.  Example:
  2471.  
  2472.       :Start
  2473.            @ECHO OFF
  2474.            NOVBAT SetUserName Name
  2475.            If ErrorLevel 255 goto Error
  2476.            NOVBAT SetMailID Mail
  2477.            If ErrorLevel 255 goto Error
  2478.            map L: = \mail\%Mail%     ;Drive L for temporary files.
  2479.            ECHO User %Name%'s Mail ID Code is: %Mail%.
  2480.            set Mail=
  2481.            set Name=
  2482.            goto End
  2483.       :Error
  2484.            ECHO NovBat ERROR: Please check your login status!
  2485.       :End
  2486.  ______________________________________________________________________
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  SetMaxUsers
  2514.  ______________________________________________________________________
  2515.  
  2516.  Function:  Sets environment var to Max # of users Netware allows.
  2517.  
  2518.  Syntax:    NOVBAT  SetMaxUsers  [VarName]
  2519.  
  2520.  Response Type:  ENVIRONMENT
  2521.  
  2522.  Remarks:
  2523.  
  2524.       Since  Novell  Netware is now sold in  versions  of  varying
  2525.       capacity,  it is sometimes useful to know what size  Netware
  2526.       you  are  using.   The SetMaxUsers command  will  create  an
  2527.       environment  variable  that contains the maximum  number  of
  2528.       concurrent users that your version of Netware will permit.
  2529.  
  2530.  See Also:  IsMaxUsers?, IsUsers@Least?, SetNumberLoggedIn
  2531.  
  2532.  Example:
  2533.  
  2534.       :Start
  2535.            @ECHO OFF
  2536.            NOVBAT SetNumberLoggedIn Now
  2537.            If ErrorLevel 255 goto Error
  2538.            NOVBAT SetMaxUsers Max
  2539.            If ErrorLevel 255 goto Error
  2540.            ECHO ----------]  Netware Usage Summary  [------------
  2541.            ECHO Max Allowed Users: %Max%, Now Logged In: %Now%
  2542.            ECHO -------------------------------------------------
  2543.            goto End
  2544.  
  2545.       :Error
  2546.            ECHO ---------------------------------------
  2547.            ECHO NOVBAT ERROR: Please check your syntax.
  2548.            ECHO ---------------------------------------
  2549.       :End
  2550.  
  2551.  
  2552.  
  2553.  ______________________________________________________________________
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  SetMessageMode
  2579.  ______________________________________________________________________
  2580.  
  2581.  Function:  Sets environment variable to message receive mode.
  2582.  
  2583.  Syntax:    NOVBAT  SetMessageMode  [VarName]
  2584.  
  2585.  Response Type:  ENVIRONMENT
  2586.  
  2587.  Remarks:
  2588.  
  2589.       The  Netware SEND command allows a user to send messages  to
  2590.       others.   Users  also  have the ability  to  block  incoming
  2591.       messages.   The SetMessageMode command will set an  environ-
  2592.       ment  variable to the message receive mode the user is  cur-
  2593.       rently  in.  The  modes are: "ALL" where  all  messages  are
  2594.       displayed, "SERVER" where only messages generated by a  file
  2595.       server  are  accepted,  and "NONE" where  all  messages  are
  2596.       blocked.
  2597.  
  2598.  See Also:  IsMessageMode?
  2599.  
  2600.  Example:
  2601.  
  2602.       :Start
  2603.            NOVBAT SetMessageMode Mode
  2604.            If ErrorLevel 255 goto Error
  2605.            If %Mode%==ALL goto All
  2606.            If %Mode%==SERVER goto Server
  2607.            ECHO ALL MESSAGES BLOCKED AT THIS TIME!
  2608.            goto End
  2609.       :All
  2610.            ECHO ALL MESSAGES ARE BEING RECEIVED.
  2611.            goto End
  2612.       :Server
  2613.            ECHO ONLY SERVER MESSAGES ARE BEING RECEIVED
  2614.            goto End
  2615.       :Error
  2616.            ECHO NovBat ERROR: Alert your System Administrator.
  2617.       :End
  2618.  ______________________________________________________________________
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  SetNetNum
  2645.  ______________________________________________________________________
  2646.  
  2647.  Function:  Sets environment variable to your network number.
  2648.  
  2649.  Syntax:    NOVBAT  SetNetNum  [VarName]
  2650.  
  2651.  Response Type:  ENVIRONMENT
  2652.  
  2653.  Remarks:
  2654.  
  2655.       The SetNetNum command creates an environment variable set to
  2656.       the network number you are connected to.  Many large  compa-
  2657.       nies  have multiple nets with connections between them.   In
  2658.       this environment you might want to restrict users to access-
  2659.       ing certain functions from some nets and not others.
  2660.  
  2661.  See Also:  IsNetNum?, IsNodeNum?, IsStationAddress?, SetNodeNum,
  2662.             SetStationAddress
  2663.  
  2664.  Example:
  2665.  
  2666.       :Start
  2667.            @ECHO OFF
  2668.            NOVBAT SetNetNum Net
  2669.            If ErrorLevel 255 goto Error
  2670.            If %Net%=250 goto Sales
  2671.       :NotOnSalesNet
  2672.            ECHO Sorry, Access to this area is restricted to
  2673.            ECHO workstations that are attached to the Sales Net!
  2674.            goto End
  2675.       :Sales
  2676.            ECHO Access Approved.
  2677.            SALES.EXE         ;Application goes here
  2678.            goto End
  2679.       :Error
  2680.            ECHO NovBat Error: Alert the System Administrator!
  2681.       :End
  2682.  
  2683.  
  2684.  ______________________________________________________________________
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  SetNetwareVer
  2711.  ______________________________________________________________________
  2712.  
  2713.  Function:  Sets environment variable to Netware Version number.
  2714.  
  2715.  Syntax:    NOVBAT  SetNetwareVer  [VarName]
  2716.  
  2717.  Response Type:  ENVIRONMENT
  2718.  
  2719.  Remarks:
  2720.  
  2721.       In  a large multi-lan environment it is possible to  be  at-
  2722.       tached  to several servers with multiple versions of  Novell
  2723.       Netware.   There are times when it is useful to  record  the
  2724.       version # of Netware you are currently using.  The SetNetwa-
  2725.       reVer  command will store your Netware version number in  an
  2726.       environment  variable. Please note that the format  for  the
  2727.       version  number is expressed without periods,  therefore  if
  2728.       you are using Netware 3.11 the variable would be set to 311.
  2729.  
  2730.  See Also:  IsNetwareVer?
  2731.  
  2732.  Example:
  2733.  
  2734.       REM Selecting a software package based on Netware Version.
  2735.       :Start
  2736.            @ECHO OFF
  2737.            NOVBAT SetNetwareVer NWVER
  2738.            If %NWVER% = 311 goto Mail1
  2739.            If %NWVER% = 215 goto Mail2
  2740.       :Mail3
  2741.            EMAIL        ;Older EMAIL SYSTEM
  2742.            goto End
  2743.       :Mail1
  2744.            EMAIL311  ;Email System for NW version 3.11
  2745.            goto End
  2746.       :Mail2
  2747.            EMAIL215  ;Email System for NW version 2.15
  2748.       :End
  2749.  
  2750.  ______________________________________________________________________
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  SetNodeNum
  2777.  ______________________________________________________________________
  2778.  
  2779.  Function:  Sets environment variable to station's node number.
  2780.  
  2781.  Syntax:    NOVBAT  SetNodeNum  [VarName]
  2782.  
  2783.  Response Type:  ENVIRONMENT
  2784.  
  2785.  Remarks:
  2786.  
  2787.       The  SetNodeNum command creates an environment variable  set
  2788.       to  the node number you are connected to.  This can be  very
  2789.       useful  for  many network functions.   By  integrating  this
  2790.       environment  variable  into  paths and  filespecs,  you  can
  2791.       develop  common login and application batch files that  per-
  2792.       form uniquely for multiple users.  While you do not need  to
  2793.       be logged in to use this command, you do need to have previ-
  2794.       ously loaded your Net Shell.
  2795.  
  2796.  See Also:  IsNetNum?, IsNodeNum?, IsStationAddress?, SetNetNum,
  2797.             SetStationAddress
  2798.  
  2799.  Example:
  2800.  
  2801.       :Start
  2802.            @ECHO OFF
  2803.            NOVBAT SetNodeNum Node
  2804.            if %Node% = 2B goto VOICEMAIL  ;station-2B is voicemail
  2805.            if %Node% = A4 goto FAXSYSTEM ;station-A4 a Fax Server
  2806.       :NormalUser
  2807.            LOGIN
  2808.            goto End
  2809.       :VOICEMAIL
  2810.            LOGIN VOICEMAIL
  2811.            goto End
  2812.       :FAXSYSTEM
  2813.            LOGIN FAX
  2814.       :End
  2815.  
  2816.  ______________________________________________________________________
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  SetNumberLoggedIn
  2843.  ______________________________________________________________________
  2844.  
  2845.  Function:  Sets environment variable to num of users logged in.
  2846.  
  2847.  Syntax:    NOVBAT  SetNumberLoggedIn  [VarName]
  2848.  
  2849.  Response Type:  ENVIRONMENT
  2850.  
  2851.  Remarks:
  2852.  
  2853.       In  some  environments it is preferable to keep  some  tasks
  2854.       from  occurring during periods of heavy network usage.   The
  2855.       SetNumberLoggedIn command will return an environment  varia-
  2856.       ble  set  to  the number of users currently  logged  into  a
  2857.       server.   This  allows  the system  administrator  to  delay
  2858.       execution of a given task until use is below a given thresh-
  2859.       old.   This  command could also be used to log usage  on  an
  2860.       ongoing basis.
  2861.  
  2862.  See Also:  IsUsersLoggedIn?, SetMaxUsers
  2863.  
  2864.  Example:
  2865.  
  2866.       :Start
  2867.            @ECHO OFF
  2868.            NOVBAT SetNunberLoggedIn USERS
  2869.            If ErrorLevel 255 goto Error
  2870.            NOVBAT SetMaxUsers Max
  2871.            If ErrorLevel 255 goto Error
  2872.            ECHO ----------------------------------------------
  2873.            ECHO Currently %Users% logged in, Maximum is %Max%!
  2874.            ECHO ----------------------------------------------
  2875.            goto End
  2876.       :Error
  2877.            ECHO NovBat ERROR:  Inform your System Administrator!
  2878.       :End
  2879.            SET Users=
  2880.            SET Max=
  2881.  
  2882.  ______________________________________________________________________
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  SetPrimaryServer
  2909.  ______________________________________________________________________
  2910.  
  2911.  Function:  Sets an environment variable to Primary Server Name.
  2912.  
  2913.  Syntax:    NOVBAT  SetPrimaryServer  [VarName]
  2914.  
  2915.  Response Type:  ENVIRONMENT
  2916.  
  2917.  Remarks:
  2918.  
  2919.       This  command  reads  the name of your  primary  server  and
  2920.       places  it  into  an environment  variable  called  "NOVBAT"
  2921.       unless you have specified the optional VarName parameter  in
  2922.       which  case  the  variable name will  match  the  parameter.
  2923.       Sufficient environment space needs to be available to  avoid
  2924.       an  error.   If enough environment space  is  not  available
  2925.       NovBat  will display a warning indicating so and  abort  the
  2926.       command  without attempting to write the new data  into  the
  2927.       environment.  Any previous data in the environment with  the
  2928.       same name will be lost.
  2929.  
  2930.  See Also:  IsDefaultServer?, IsPrimaryServer?, SetDefaultServer
  2931.  
  2932.  Example:
  2933.  
  2934.       :Start
  2935.            NOVBAT SetUserName Name
  2936.            If ErrorLevel 255 goto Error
  2937.            NOVBAT SetPrimaryServer
  2938.            If ErrorLevel 255 goto Error
  2939.            ECHO ------------------------------------------
  2940.            ECHO User: %Name% - Primary Server: %NovBat%.
  2941.            ECHO ------------------------------------------
  2942.            set Name=
  2943.            set NovBat=
  2944.            goto End
  2945.       :Error
  2946.            ECHO NovBat Error: Alert your system supervisor!
  2947.       :End
  2948.  ______________________________________________________________________
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.  
  2955.  
  2956.  
  2957.  
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.  
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  SetSizeOfGroup
  2975.  ______________________________________________________________________
  2976.  
  2977.  Function:  Sets environment variable to num of members of group.
  2978.  
  2979.  Syntax:    NOVBAT  SetSizeOfGroup  GroupName  [VarName]
  2980.  
  2981.  Response Type:  ENVIRONMENT
  2982.  
  2983.  Remarks:
  2984.  
  2985.       This command reads the number of members of the group Group-
  2986.       Name  and places this number into the  environment  variable
  2987.       indicated by VarName.  This function can easily be used as a
  2988.       meter  for  information about  department  sizes,  workgroup
  2989.       management,  etc.   You do not need to be a  member  of  the
  2990.       group that you are checking.
  2991.  
  2992.  See Also:  DoesGroupExist?
  2993.  
  2994.  Example:
  2995.  
  2996.       :START
  2997.            @ECHO OFF
  2998.            NOVBAT SetSizeOfGroup Everyone
  2999.            NOVBAT SetSizeOfGroup SALES Sales
  3000.            NOVBAT SetSizeOfGroup PRODUCTION Prod
  3001.            NOVBAT SetSizeOfGroup SHIPPING Ship
  3002.            NOVBAT SetSizeOfGroup ENGINEERING Engin
  3003.            ECHO ---------------------------------------------
  3004.            ECHO Current size of Various Departments:
  3005.            ECHO ---------------------------------------------
  3006.            ECHO SALES:                         %Sales%
  3007.            ECHO PRODUCTION:                    %Prod%
  3008.            ECHO SHIPPING:                      %Ship%
  3009.            ECHO ENGINEERING:                   %Engin%
  3010.            ECHO ---------------------------------------------
  3011.            ECHO TOTAL:                         %NovBat%
  3012.            ECHO ---------------------------------------------
  3013.       :End
  3014.  ______________________________________________________________________
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  SetStationAddress
  3041.  ______________________________________________________________________
  3042.  
  3043.  Function:  Sets environment variable to network station address.
  3044.  
  3045.  Syntax:    NOVBAT  SetStationAddress  [VarName]
  3046.  
  3047.  Response Type:  ENVIRONMENT
  3048.  
  3049.  Remarks:
  3050.  
  3051.       This command returns the user's station address as an  envi-
  3052.       ronment  string.   The  syntax for the  station  address  is
  3053.       "StationNum:NodeNum".  The StationNum portion of the  result
  3054.       is  returned in decimal and the NodeNum portion of  the  ad-
  3055.       dress is returned in Hex.  For example, if the user's  work-
  3056.       station  is node number 200 (decimal) on network number  250
  3057.       then  the result returned by the  SetStationAddress  command
  3058.       would be "250:C8".
  3059.  
  3060.  See Also:  IsNetNum?, IsNodeNum?, IsStationAddress?, SetNetNum,
  3061.             SetNodeNum
  3062.  
  3063.  Example:
  3064.  
  3065.       :Start
  3066.            @ECHO OFF
  3067.            NOVBAT SetStationAddress Addr
  3068.            If ErrorLevel 255 goto Error
  3069.            NOVBAT SetUserName Name
  3070.            If ErrorLevel 255 goto Error
  3071.            ECHO ------------------------------------------------
  3072.            ECHO You are user %Name%, currently logged into
  3073.            ECHO workstation %Addr%.
  3074.            ECHO ------------------------------------------------
  3075.            goto End
  3076.       :Error
  3077.            ECHO NovBat Error: Alert your system supervisor!
  3078.       :End
  3079.  
  3080.  ______________________________________________________________________
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.  
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  SetTotalEMS
  3107.  ______________________________________________________________________
  3108.  
  3109.  Function:  Sets environment variable to total amount of EMS RAM.
  3110.  
  3111.  Syntax:    NOVBAT  SetTotalEMS  [VarName]
  3112.  
  3113.  Response Type:  ENVIRONMENT
  3114.  
  3115.  Remarks:
  3116.  
  3117.       This  command determines how many k of EMS memory exists  in
  3118.       the workstation and sets an environment variable  according-
  3119.       ly.  This does not imply that all of this EMS is  available.
  3120.       Use  SetFreeEMS  to  determine this.   SPECIAL  NOTE:   This
  3121.       command  does not require Netware and can be used in a  non-
  3122.       network environment.
  3123.  
  3124.  See Also:  IsFreeEMS@Least?, IsTotalEMS@Least?, SetFreeEMS
  3125.  
  3126.  Example:
  3127.  
  3128.       :Start
  3129.            @ECHO OFF
  3130.            NOVBAT SetFreeEMS EMSAVAIL
  3131.            NOVBAT SetTotalEMS EMSTOTAL
  3132.            NOVBAT SetFreeRAM RAMAVAIL
  3133.            NOVBAT SetTotalRAM RAMTOTAL
  3134.  
  3135.            ECHO --------------] Memory Summary [---------------
  3136.            ECHO EMS:  %EMSTOTAL%, Avail: %EMSAVAIL%.
  3137.            ECHO RAM:  %RAMTOTAL%, Avail: %RAMTOTAL%.
  3138.            ECHO -----------------------------------------------
  3139.  
  3140.            set EMSAVAIL=
  3141.            set EMSTOTAL=
  3142.            set RAMAVAIL=
  3143.            set RAMTOTAL=
  3144.       :End
  3145.  
  3146.  ______________________________________________________________________
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  SetTotalRAM
  3173.  ______________________________________________________________________
  3174.  
  3175.  Function:  Sets environment variable to total amount of DOS RAM.
  3176.  
  3177.  Syntax:    NOVBAT  SetTotalRAM  [VarName]
  3178.  
  3179.  Response Type:  ENVIRONMENT
  3180.  
  3181.  Remarks:
  3182.  
  3183.       This command determines how much system RAM (Expressed in k)
  3184.       exists  in the workstation and sets an environment  variable
  3185.       accordingly.  This does not imply that all of this memory is
  3186.       unused and available.  Use the SetFreeRAM command to  deter-
  3187.       mine  this.   SPECIAL NOTE:  This command does  not  require
  3188.       Netware and can be used in a non-network environment.
  3189.  
  3190.  See Also:  IsFreeRAM@Least?, IsTotalRAM@Least?, SetFreeRAM
  3191.  
  3192.  Example:
  3193.  
  3194.       :Start
  3195.            @ECHO OFF
  3196.            NOVBAT SetFreeEMS EMSAVAIL
  3197.            NOVBAT SetTotalEMS EMSTOTAL
  3198.            NOVBAT SetFreeRAM RAMAVAIL
  3199.            NOVBAT SetTotalRAM RAMTOTAL
  3200.  
  3201.            ECHO --------------] Memory Summary [---------------
  3202.            ECHO EMS:  %EMSTOTAL%, Avail: %EMSAVAIL%.
  3203.            ECHO RAM:  %RAMTOTAL%, Avail: %RAMTOTAL%.
  3204.            ECHO -----------------------------------------------
  3205.  
  3206.            set EMSAVAIL=
  3207.            set EMSTOTAL=
  3208.            set RAMAVAIL=
  3209.            set RAMTOTAL=
  3210.       :End
  3211.  
  3212.  ______________________________________________________________________
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  SetUserName
  3239.  ______________________________________________________________________
  3240.  
  3241.  Function:  Sets environment variable to your Netware user name.
  3242.  
  3243.  Syntax:    NOVBAT  SetUserName  [VarName]
  3244.  
  3245.  Response Type:  ENVIRONMENT
  3246.  
  3247.  Remarks:
  3248.  
  3249.       This  command simply reads the user's name into an  environ-
  3250.       ment  variable.  Once in the environment,  this  information
  3251.       can be used for many purposes.  By incorporating this varia-
  3252.       ble into batch files, you can have application automatically
  3253.       route output or temporary files into a user's home  directo-
  3254.       ry, where they will not conflict with other users.
  3255.  
  3256.  See Also:  IsUserName?
  3257.  
  3258.  Example:
  3259.  
  3260.       :Start               ;Assumed to be part of a login
  3261.            @ECHO OFF       ;batch file.
  3262.            NOVBAT SetUserName Name
  3263.       :End
  3264.  
  3265.  
  3266.  
  3267.       rem * HOME.BAT - Takes user to home directory *
  3268.       rem This Batch file assumes the user name will be found
  3269.       rem in an environment variable called "NAME".
  3270.       :Start
  3271.            @ECHO OFF
  3272.            F:
  3273.            cd \home\%name%
  3274.       :End
  3275.  
  3276.  
  3277.  
  3278.  ______________________________________________________________________
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.  
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.  SetVideo
  3305.  ______________________________________________________________________
  3306.  
  3307.  Function:  Sets environment variable to graphics adapter type.
  3308.  
  3309.  Syntax:    NOVBAT  SetVideo  [VarName]
  3310.  
  3311.  Response Type:  ENVIRONMENT
  3312.  
  3313.  Remarks:
  3314.  
  3315.       Since workstations will have different display adapters,  it
  3316.       can  be useful to store which adapter a system has  for  se-
  3317.       lecting the correct software drivers for that system.   This
  3318.       command  stores the name of the adapter into  the  specified
  3319.       environment variable.  The possible result strings are   MGA
  3320.       or HERC, CGA, MCGA, EGA, VGA, and PGA.   SPECIAL NOTE:  This
  3321.       command  does not require Netware and can be used in a  non-
  3322.       network environment.
  3323.  
  3324.  See Also:  IsVideo?
  3325.  
  3326.  Example:
  3327.  
  3328.       :Start               ;Assumed to be part of a login
  3329.            @ECHO OFF       ;batch file.
  3330.            NOVBAT SetVideo Vid
  3331.       :End
  3332.  
  3333.  
  3334.       rem * SPRDSHET.BAT - Uses VID var to enter a spreadsheet *
  3335.       rem Batch file assumes users video adapter will be found
  3336.       rem in an environment variable named "VID".
  3337.       :Start
  3338.            @ECHO OFF
  3339.            F:
  3340.            cd \PUBLIC\APPS\SPREAD\%Vid%
  3341.            SPRDSHET
  3342.       :END
  3343.  
  3344.  ______________________________________________________________________
  3345.  
  3346.  
  3347.  
  3348.  
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354.  
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362.  
  3363.  
  3364.  
  3365.  
  3366.  
  3367.  
  3368.  
  3369.  
  3370.  APPENDIX A - NovBat Command Summary
  3371.  ----------------------------------------------------------
  3372.  Command              Parameters                Result Type
  3373.  ----------------------------------------------------------
  3374.  DoesGroupExist?      <Group>                    ERRORLEVEL
  3375.  DoesGroupHaveMember? <Group> <UserName>         ERRORLEVEL
  3376.  DoesUserExist?       <UserName>                 ERRORLEVEL
  3377.  IsAttached?          <ServerName>               ERRORLEVEL
  3378.  IsDefaultServer?     <ServerName>               ERRORLEVEL
  3379.  IsCPU?               <8088, 286, 386, 486>      ERRORLEVEL
  3380.  IsDOSVer?            <DosVer> {Less the <.>}    ERRORLEVEL
  3381.  IsDosVerSince?       <DosVer> {Less the <.>}    ERRORLEVEL
  3382.  IsFreeEMS@Least?     <Number> {Expressed in k}  ERRORLEVEL
  3383.  IsFreeRAM@Least?     <Number> {Expressed in k}  ERRORLEVEL
  3384.  IsFullName?          <FullUserName>             ERRORLEVEL
  3385.  IsMailID?            <MailIDCode>               ERRORLEVEL
  3386.  IsMaxUsers?          <Number>                   ERRORLEVEL
  3387.  IsMessageMode?       <ALL, SERVER, or NONE>     ERRORLEVEL
  3388.  IsNetNum?            <Number>                   ERRORLEVEL
  3389.  IsNetwareVer?        <Number> {Less the <.>}    ERRORLEVEL
  3390.  IsNodeNum?           <Number>                   ERRORLEVEL
  3391.  IsPrimaryServer?     <ServerName>               ERRORLEVEL
  3392.  IsSecurityEquiv?     <Group/User>               ERRORLEVEL
  3393.  IsStationAddress?    <Number>                   ERRORLEVEL
  3394.  IsTotalEMS@Least?    <Number> {Expressed in k}  ERRORLEVEL
  3395.  IsTotalRAM@Least?    <Number> {Expressed in k}  ERRORLEVEL
  3396.  IsUserDuplicated?    <UserName>                 ERRORLEVEL
  3397.  IsUserLoggedIn?      <UserName>                 ERRORLEVEL
  3398.  IsUserName?          <UserName>                 ERRORLEVEL
  3399.  IsUsers@Least?       <Number>                   ERRORLEVEL
  3400.  IsVideo?     <MGA, CGA, MCGA, EGA, VGA, or PGA> ERRORLEVEL
  3401.  SetCPU               = No Parameters =         ENVIRONMENT
  3402.  SetDefaultServer     = No Parameters =         ENVIRONMENT
  3403.  SetDOSVer            = No Parameters =         ENVIRONMENT
  3404.  SetFreeEMS           = No Parameters =         ENVIRONMENT
  3405.  SetFreeRAM           = No Parameters =         ENVIRONMENT
  3406.  SetFullName          = No Parameters =         ENVIRONMENT
  3407.  SetMailID            = No Parameters =         ENVIRONMENT
  3408.  SetMaxUsers          = No Parameters =         ENVIRONMENT
  3409.  SetMessageMode       = No Parameters =         ENVIRONMENT
  3410.  SetNetNum            = No Parameters =         ENVIRONMENT
  3411.  SetNetwareVer        = No Parameters =         ENVIRONMENT
  3412.  SetNodeNum           = No Parameters =         ENVIRONMENT
  3413.  SetNumberLoggedIn    = No Parameters =         ENVIRONMENT
  3414.  SetPrimaryServer     = No Parameters =         ENVIRONMENT
  3415.  SetSizeOfGroup       <Group>                   ENVIRONMENT
  3416.  SetStationAddress    = No Parameters =         ENVIRONMENT
  3417.  SetTotalEMS          = No Parameters =         ENVIRONMENT
  3418.  SetTotalRAM          = No Parameters =         ENVIRONMENT
  3419.  SetUserName          = No Parameters =         ENVIRONMENT
  3420.  SetVideo             = No Parameters =         ENVIRONMENT
  3421.  __________________________________________________________
  3422.  
  3423.  
  3424.  
  3425.  
  3426.  
  3427.  
  3428.  
  3429.  
  3430.  
  3431.  
  3432.  
  3433.  
  3434.  
  3435.  
  3436.  
  3437.  
  3438.                       ╔═════════════════════╗
  3439.                       ║ * I D L E B O O T * ║
  3440.                       ╚═════════════════════╝
  3441.               A Workstation Security Management Tool
  3442.  
  3443.       IdleBoot  is  a security tool designed  to  assist   network
  3444.  administrators  manage their networks by  automatically  removing
  3445.  inactive  workstations  from  the net.  IdleBoot is  a  TSR  that
  3446.  identifies when a workstation is idle, then after a  configurable
  3447.  
  3448.  delay  will force a  network logoff and then reboot of the  inac-
  3449.  tive  system.  System idleness is configurable on a  user-by-user
  3450.  or an application-by-application basis by the lan administrator.
  3451.  
  3452.       IdleBoot  solves many  network  based   problems.   Security
  3453.  holes caused when users abandon their logged in workstations  are
  3454.  eliminated  reducing  the likelihood of  unauthorized  access  to
  3455.  sensitive  information  or vandalism.   Other  problems  resolved
  3456.  include  those caused by users who leave their workstations  with
  3457.  files  open.   Not only do open files prevent  other  users  from
  3458.  having access to the information they contain, inactive  worksta-
  3459.  tions can bottleneck a properly metered lan needlessly preventing
  3460.  access  to mission critical applications.  Even the routine  task
  3461.  of backing up the lan can be adversely affected by these inactive
  3462.  workstations.
  3463.  
  3464.       Designed  specifically  for the networking  environment  and
  3465.  developed in  assembly  language  IdleBoot requires less than  2k
  3466.  of system ram, and can be loaded into high memory. Many  optional
  3467.  features  such as audible  alarms,  reboot at a  specific   time,
  3468.  hot-key override, etc. are supported to provide maximum flexibil-
  3469.  ity.
  3470.  
  3471.       IdleBoot  is licensed based upon the number of  workstations
  3472.  on your net.  Prices are as follows:
  3473.  
  3474.     ╔═════════════════════════════╦══════════════════════════╗
  3475.     ║ Single User         $29.95  ║  50 User         $249.95 ║
  3476.     ║ 10 User             $99.95  ║ 100 User         $309.95 ║
  3477.     ║ 20 User            $179.95  ║ 250 User         $349.95 ║
  3478.     ╚═════════════════════════════╩══════════════════════════╝
  3479.  
  3480.  
  3481.  
  3482.  
  3483.  
  3484.  
  3485.  
  3486.  
  3487.  
  3488.  
  3489.  
  3490.  
  3491.  
  3492.  
  3493.  
  3494.  
  3495.  
  3496.  
  3497.  
  3498.  
  3499.  
  3500.  
  3501.  
  3502.  
  3503.  
  3504.  
  3505.                        ╔═══════════════════╗
  3506.                        ║ ** N O V B A T ** ║
  3507.                        ╚═══════════════════╝
  3508.  
  3509.          A Novell Netware Batch File Enhancement Utility
  3510.  
  3511.       The one common language that all system administrators  have
  3512.  to work in is the DOS batch file.  But at its best the Batch file
  3513.  is a very weak job control language.  This problem is only ampli-
  3514.  fied by the requirements of the network environment.  Batch files
  3515.  simply  can't provide the power that todays System  administrator
  3516.  must  have  for  developing smart network  user  and  application
  3517.  tasks.  NovBat has solved this long-lived dilemma.
  3518.  
  3519.       NovBat  (short for "Novell Batch Enhancer")  allows  you  to
  3520.  develop "Network Smart" batch files.  NovBat increases the  power
  3521.  of your batch files by giving you access into the Netware operat-
  3522.  ing system.  Now you can develop login scripts that are sensitive
  3523.  to the conditions of the network, the workstation, and the  user.
  3524.  With  NovBat you can easily interrogate the network for  informa-
  3525.  tion  that  previously required using a plethora of  third  party
  3526.  utilities.
  3527.  
  3528.  NovBat supports commands like:
  3529.  
  3530.  IsUserLoggedIn?   Is "BOB" currently logged into the net?
  3531.  IsMemberOfGroup?  Is "BOB" a member of the "SALES" GROUP?
  3532.  User@Con?         What connection is BOB at?
  3533.  NodeNum?          What Node # am I logged into?
  3534.  IsFreeEMS@Least?  Do I have at least "300k" of unused EMS?
  3535.  SetDOSVer?        What Version of DOS am I using?
  3536.  IsVideo?          What Graphics Adapter am I using?
  3537.  IsDefaultServer?  Is my server the "SALES_SERVER"?
  3538.  
  3539.       NovBat  contains over 50 netware-based commands  that   help
  3540.  the system  administrator/installer develop powerful batch  files
  3541.  quickly.  NovBat returns information  to your batch file  through
  3542.  use of the ERRORLEVEL function and  environment variables.
  3543.  
  3544.       NovBat  is licensed per fileserver.  You need to purchase  a
  3545.  license for each fileserver on your network. NovBat prices are as
  3546.  follows:
  3547.  
  3548.   ╔══════════════════════════════╦══════════════════════════════╗
  3549.   ║     1 Server   $99.95        ║ 31-50 Servers  $69.95/Server ║
  3550.   ║  2-10 Servers  $89.95/Server ║ 51-99 Servers  $79.95/Server ║
  3551.   ║ 11-30 Servers  $79.95/Server ║   100 Servers+ $49.95/Server ║
  3552.   ╚══════════════════════════════╩══════════════════════════════╝
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.  
  3560.  
  3561.  
  3562.  
  3563.  
  3564.  
  3565.  
  3566.  
  3567.  
  3568.  
  3569.  
  3570.  
  3571.  
  3572.                       █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  3573.  █▀█▀█▀▀█▀▀█▀▀▀█▀▀▀█▀▀▀ H O R I Z O N S ▀▀▀▀█▀▀▀█▀▀▀█▀▀█▀▀█▀█▀█
  3574.  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Consulting ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  3575.    ≡ 1432 E. Commercial Street ─ Springfield, MO  65803 USA ≡
  3576. ≡ Phone:(417) 839-2174, Fax:(417) 831-1329, BBS:(417) 831-9140 ≡
  3577.  ┌────────────────────────────────────────────────────────────┐
  3578.  │                    ≡ NovBat - Order Form ≡                 │
  3579.  └────────────────────────────────────────────────────────────┘
  3580.  Please send me The commercial release of NovBat.  I understand
  3581.  that this version does not contain the intermittent evaluation
  3582.  prompt screen, or a built in time-out.
  3583.  =============================================================
  3584.  
  3585.  Name:        ________________________________________________
  3586.  
  3587.  Company:     ________________________________________________
  3588.  
  3589.  Title:       ________________________________________________
  3590.  
  3591.  Address:     ________________________________________________
  3592.  
  3593.  City/St/Zip: ________________________________________________
  3594.  
  3595.  Phone:       (_______) _____________________ Ext: ___________
  3596.  
  3597.  Fax:         (_______) _____________________
  3598.  
  3599.     Comments:    _____________________________________________
  3600.  
  3601.                  _____________________________________________
  3602.    ____ Single Server NovBat                      - $99.95
  3603.  
  3604.    ____ Site License:    ______ Servers (See Chart) $_________
  3605.  
  3606.  Shipping  USA      - $2.00      + Shipping         $_________
  3607.            CANADA   - $3.00
  3608.            OVERSEAS - $6.00                Total $____________
  3609.  
  3610.  Credit Card #: ____________________ Expiration Date: ________
  3611.  
  3612.  Master Card ___   Visa ___   Discover ___   COD (Add $7) ____
  3613.     For Faster Service, You may can Fax us this order form.
  3614.         Purchase Orders accepted after credit approval.
  3615.   ╔═════════════════════════════════════════════════════════════╗
  3616.   ║       ≡ NOVBAT Network Site License Price Schedule ≡        ║
  3617.   ╠══════════════════════════════╦══════════════════════════════╣
  3618.   ║     1 Server   $99.95        ║ 31-50 Servers  $69.95/Server ║
  3619.   ║  2-10 Servers  $89.95/Server ║ 51-99 Servers  $79.95/Server ║
  3620.   ║ 11-30 Servers  $79.95/Server ║   100 Servers+ $49.95/Server ║
  3621.   ╚══════════════════════════════╩══════════════════════════════╝
  3622.   For licenses greater than 250 Servers, call for a price quote.
  3623.   ──────────────────────────────────────────────────────────────
  3624.           Missouri residents add 5.975% sales tax.
  3625.       Unless otherwise indicated, 3 1/2 format is provided.
  3626.